home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 3: CDPD 3
/
Almathera Ten on Ten - Disc 3: CDPD3.iso
/
fish
/
726-750
/
750
/
execmaster
/
execmaster.doc
< prev
next >
Wrap
Text File
|
1995-03-18
|
14KB
|
560 lines
DOCUMENTATION
ExecMaster VERSION 1.7 FREEWARE VERSION
written 1992 by H.P.G.
INDEX:
Index Page 2
Genearl Description 3
SYSTEM 3
Legal Stuff 4
Features 5
Installation 5
Starting ExecMaster 6
ExecMaster Start PARAMETERs 7
Description of the Intuition Interface 8,9
Technical 10
Last 10
Address 10
Append:
List of Files
General Description:
ExecMaster [ EM ] is a program which is an enhancement for the
menuitem 'Execute Command' of the WBench 2.xx.
- With EM you can execute Cli commands, ARexx scripts, batch
scripts or just programs.
- The output can be redirected
- With EM you can easily edit batch files.
SYSTEM:
For EM you need at minimum Kickstart 2.xx and ASL.Library 37.xx.
You must have Run and Execute in your current AmigaDOS searchpath
If you want to use all functions of EM you should also have the
Rx command in your searchpath.
NOTIZ: Because of EM`s use of the new OS 2.0 features EM is not
able to run under 1.2 1.3 .
Legal Stuff:
This program and all files come with it also the docfiles are released
as FREEWARE.
this means:
everybody may use ExecMaster,
everybody may copy ExecMaster, if:
1. you copy all included files see list below
2. no changes are made , this means the program amd all included files
must stay in the origin form. Exception: you may archieve it ; but
in this way you must also archieve the whole package.
3. if you recompile it, you have to include a notice to the original
author. if you also want to (re)distribute in this form you have to
send me a copy.
4. you may not sell ExecMaster
except: you`re allowed to take a small copy fee which
may not extend 5$.
5. if you want to include ExecMaster or one of the included files as a part
of a commercial package, you must have written permission of the
author (address see below)
I take no warranty or garanty for the function of this program.
The whole risk of using it stays by the user.
(But I don`t think there are many bugs in this program)
Now we come to the more interesting part:
FEATURES:
- EM has a full mousedriven GadTools userinterface.
- All functions are also available by pressing several keys
- You can specify whole command lines.
- You can execute ARexx scripts.
- You can execute batch scripts.
- You can call other programs.
- You can redirect the Output to anything you want.
- EM has the ability to iconify.
- Also if EM is iconified, all functions are still available by
pressing keys.
- All commands and/or programs can be selected by use of the ASL
filerequester.
- All settings of the main and the iconfied window can be set
via commandline parameters.
- You can specify the width of the iconified window at starttime.
- Several default options can be set also at starttime.
- There are also some keycodes for system gadgets (ZoomGadget
CloseGadget)
- Full support of public screens. That means EM opens its window
always on default PublicScreen.
- All gadgets have org. WB 2.xx design und function.
- No BUSY-LOOPS
Installation:
Just copy ExecMaster into your C: or any other dir in your current
AmigaDOS searchpath.
Starting ExecMaster:
EM must be startet from CLI, if you want to specify any parameter.
Alternativly you can use the WBenchmenuitem 'ExecuteCommand' to
call EM.
Certainly you can use ExecMaster via doubleclick on its icon,
but in this case EM use its defaults.
If you want to call ExecMaster via doubleclick and give any
arguments to it it is very useful to create a project icon. Add
as DefaultTool 'c:IconX' and save it under the name 'EMaster.info'.
Then type in the text
e.g.
ExecMaster CMD dir df0: ICONIFY
If you saved this text as e.g. EMaster and set the s-bit by
typing 'protect EMaster +s' in the Cli you can start EM by
doubleclicking on the EMaster icon.
A disadvantage herefor is that the window of IconX stays until
EM finished. but if you type in EMaster
RUN >NIL: ExecMaster .......
you can provide that. Therefor you mast take care that you must
specify an output for EM (see below) if you want to get any output.
An example call:
RUN >NIL: ExecMaster OUTP "CON:0/0///EM_Output/WAIT" OUTON
The Wait flag causes the window to close after you put in 'ctrl-\'.
If you donot specify WAIT the window closes suddenly after executing
any command. If you use the WAIT flag you will get time to read the
informations in the window first.
ExecMaster START PARAMETERs:
EM has the following
Syntax: ExecMaster CMD/K,OUTP/K,ICONIFY/S,OUTON/S,X/N,Y/N,ZX/N,ZY/N,ZW/N
with:
* CMD String if you specify CMD following by a string
the string will be copied to the command
StringGadget. (see below)
* OUTP String if you specify OUTP following by a string
this string will be copied to the output
StringGadget (s.b.)
* ICONIFY ------------ if you specify ICONIFY EM starts iconfied
* OUTON ------------ if you specify OUTON the CheckBox will be
selected. If this Checkbox is selected
all Output will be sent to the contents
of the output StringGadget.
Default: CheckBox unselected
* X Number if you specify x following by a number
EM opens its window with its leftedge
depending on this value.
* Y Number specifies the topedge of the window
* ZX Number specifies the leftedge of the iconified
window.
* ZY Number specifies the topedge of the iconified
window
* ZW Number specifies the width of the iconified
window.
361 > ZW > 119 Its value must be between 120 and 360,
otherways it will be ignored.
With this argument you can prevent you
from ugly holes on your ScreenTitle
when you have also other programs with
iconified windows running while using
EM.
*** Starting EM without any PARAMETER or from WBench by doubleclicking, the
*** command StringGadget stays empty. The CheckBox is always selected. The
*** iconified window first appears always on coords 0,0; the main window
*** appears in the middle of the screen
Description of the Intuition Interface:
Following is a description of the functions of EM and their
usage:
( Characters in the '[]'s represents the keys you can
use instead of activating the gadget )
Command [c|C] (Pressing c or C)
This activates the command StringGadget. You can type in the
name of the command you want to execute. If you press the TAB
key instead of the RETURN key, the next StringGadget will be
activated. If you press Shift-TAB the previous one will be
activated.
Output [o|O]
This activates the output StringGadget. You can type in the
output you want the command to use. You can type in there e.g.
simply 'CON:' to get the default CON: window. You can also type
in a filename where all outputs of the command will be sent to.
E.G.
if you specify 'Ram:File' as output,
and 'dir c:' as command, you get the file
'Ram:File' which contains all filenames of the
c: dir.
......
addbuffers
avail
......
If you want no output you can deselect the CheckBox (s.b.)
or type NIL: in the output StringGadget.
Input cannot be indirected.
| | [+]
The CheckBox (on the right hand side of the output String
Gadget) specifies if EM should use the contents of the output
StringGadget as output for the command or not. If the CheckBox
is selected the output will be used. This is useful if you want
to try out different outputs or you want to write a list of
files. So first you can inactivate the CheckBox and then type in
the name of the destinationfile in the output StringGadget. Then
type in the command StringGadget e.g. List . If you execute this
by pressing Cmd (s.b.) the list of the files appears in the Cli
window EM is started from. If you want to write this listing
then to file you can activate the CheckBox and the output will
be sent to the filename.
RUN [r|R]
If you chose Run the command will be executed via C:Run as a
backgroundprocess. Also in this case all output will be sent to
the specified output.
Script [s|S]
With Script you can start a batch script. This script will
be executed by calling C:Execute. This is useful to execute batch
files which have not not set their S-Bit. If their S-Bit is set
you can simply use Cmd (s.b).
Rexx [x|X]
This starts a Rexx script by calling the Rx commmand. this
should be located in the REXX: Assign or in any other place in
your AmigaDOS searchpath (usually its in sys:Rexxc)
Select [e|E]
This opens the ASLFileRequester that lets you select a file
which will be prompted in the command StringGadget.
Cmd [m|M]
This executes the contents of the command StringGadget as a
whole command line (unchanged). You can here specify not only a
command you can also type in a whole command line with arguments
and parameters.
e.g: you can type in:
'list df0:system/setm#?' or
'hdtoolbox'
Any output will be sent to the specified output.
Iconify [i|I]
This (re)iconifies the window. You can therefor also
activate the ZoomGadget of the window. After (first) iconifying a
little window appears on the left upper corner of your screen.
Typing i or activating the ZipGadget again will bring back the
old window on the old position.
Note: Especially if the window is iconified you`ll see the advantage of
the EM`s key command support. All functions of EM are still
available although you can`t see any gadgets yet. Its like you
get a very small full functionally Cli window. (great ey ?)
Quit [q|Q]
Quits the program. You can also use 'q' or the CloseGadget of
the window
Technical:
EM is written with the Manx Aztec C V 5.2a - Compiler
EM uses the new DOS functions ReadArgs for CommandLineParsing.
The Intuition interface is created and managed by the GadTools
Library The FileRequester is from the ASL.Library.
Last:
Ich hope EM will be used by a lot of people. If you find bugs
send me a message. Also serious critic and/or ideas are wellcomed.
Address:
Send all messages to:
Hans - Peter Guenther
Gruener Weg 5
3501 Fuldatal 2
( B.R.D )
Have fun ...
H.P.G
PS:
List of files:
(If you miss any of the files below you release is incomplete)
ExecMaster : binary
ExecMaster.info
ExecMaster.dok : german manual
ExecMaster.dok.info
ExecMaster.doc : english manual
ExecMaster.doc.info
Examples (Dir)
.edrc.dme : part of a DMe startup file
.edrc.dme.info
Csh.start.sh : part of a Csh startup file
Csh.start.sh.info
EMaster : batch file
EMaster.info
User-Startup : part of a user-startup file
User-Startup.info
Examples.info
---
END